home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / ez_diz12.zip / EZ-DIZ.DOC < prev    next >
Text File  |  1992-02-17  |  9KB  |  217 lines
  1.                                         
  2.                                   EZ-DIZ v1.2
  3.                          Copyright (c) 1992 By Rick Kuban
  4.  
  5.  
  6.           INTRODUCTION:
  7.           -------------
  8.                EZ-DIZ is a utility program written to automate and
  9.           speed up a PCBoard 14.5+ sysop's maintainance of the upload
  10.           directory files list using the FILE_ID.DIZ and DESC.SDI files
  11.           in ZIP/ARC/ARJ/PAK/LZH archives. It provides similar functions
  12.           as the PCBDESC utility, but functions from the command line,
  13.           unlike PCBDESC, and *DOES NOT* require "Local Uploads".
  14.  
  15.           It may be manually used one file at a time, or, by clever use
  16.           of a batch file (as intended), can be used to automatically
  17.           process an entire directory at one time. It contains the
  18.           intelligence required to not process a file that has already
  19.           been placed in the dir listing. It is suitable to run in an
  20.           event, if desired.
  21.  
  22.           EZ-DIZ now automatically recognizes ZIP/PAK/ARC/LZH and ARJ
  23.           formats, and, if the appropriate decompressor is available,
  24.           will process the file. If a file in the directory is not an
  25.           archive, it will simply be skipped.
  26.  
  27.  
  28.           STANDARD "DEMO" LICENSE:
  29.           ------------------------
  30.               EZ-DIZ is a Shareware program, and uploading of the code
  31.           to various bulletin boards and Shareware libraries is encouraged.
  32.           Several limitations must be implied, however:
  33.  
  34.           1)  Under no circumstances should the code be modified or dis-
  35.           tributed in any other form than what it was originally supplied
  36.           by the author. The exception is that EZ-DIZ may be compressed
  37.           using techniques other than ZIP, but the de-compressed form of
  38.           EZ-DIZ must remain intact. No files may be added to or removed
  39.           from the archive contents. This explicitly includes bbs ads of
  40.           any kind.
  41.  
  42.           Files included in the original archive are:
  43.  
  44.                    EZ-DIZ.EXE - the executable program file
  45.                    EZ-DIZ.DOC - this documentation file
  46.                    QUICK.DOC - a quick start for old & new users
  47.                    EZDIZ.BAT - sample batch file (single)
  48.                    B-DIZ.BAT - sample batch file (batch)
  49.                    EZ-DIZ.REG - registration form
  50.                    FILE_ID.DIZ  - description file
  51.  
  52.           2)  EZ-DIZ may not be redistributed in any manner other than
  53.           electronic file transfer unless cleared with the author beforehand.
  54.           No money may be received for EZ-DIZ except to cover for telecom-
  55.           munications/service charges, and in such a case the cost may not
  56.           exceed $5.00 in US funds.
  57.  
  58.           3)  EZ-DIZ may be run for a period of time adequate to allow
  59.           for full testing of the software. If, after running the code for
  60.           one month, you decide not to purchase the registration license,
  61.           you must forfeit this license and remove EZ-DIZ from operation
  62.           on your system(s). You may keep a copy online for distribution
  63.           purposes only.
  64.  
  65.            4)  EZ-DIZ may not be hacked or modified in ANY manner.
  66.  
  67.  
  68.           REGISTRATION LICENSE:
  69.           ---------------------
  70.           1)   Once purchasing the registration license, the license is
  71.           extended for life. All future releases of EZ-DIZ will be made
  72.           available, for no additional charge. Upon each issuance of a later
  73.           revision, registrations will not be accepted for older versions.
  74.  
  75.           2)   The registration license is non-refundable and non-transfer-
  76.           able without prior consent of the author. The registration license
  77.           permits the licensee to operate EZ-DIZ on one (1) system only.
  78.           The definition of "system" will be construed to include a multiple
  79.           node network at the same physical location, operating under the
  80.           same bbs name.
  81.  
  82.           3)   The registration fee for EZ-DIZ v1.2 is $10.00 in US funds.
  83.  
  84.           4)   Product support for EZ-DIZ will be provided to registered
  85.           users thru Technoid's Toybox BBS, (214) 226-6017. The user should
  86.           call Technoid's Toybox, after giving the mail time to arrive, to
  87.           download their registration key which will enable the advanced
  88.           features, and/or remove the "UNREGISTERED COPY" notices from the
  89.           program.
  90.  
  91.           If desired, the user can include an additional $5.00 US with the
  92.           registration fee to cover postage and handling and a copy of the
  93.           latest version of EZ-DIZ and their registration key will be
  94.           returned via U.S. Mail on 5.25" 360k IBM Format disk.
  95.  
  96.           DISCLAIMER:
  97.           -----------
  98.                Although the program has been tested, and is currently in
  99.           use on the authors bbs, the author assumes no responsibility nor
  100.           liability for any data loss, incurred costs, equipment or other
  101.           damage as a result of the use of EZ-DIZ. The user assumes all
  102.           risk for damages incurred from the use of this product.
  103.  
  104.           EZ-DIZ has been tested on PCBoard v14.5a, multi-node, running on
  105.           a LANtastic v4.0 network under MS DOS v3.3. The versions of various
  106.           decompression programs used in testing are:
  107.  
  108.           PKUNZIP v1.10 / PKUNPAK v3.61 / LHA v2.12 / PAK v2.10 / ARJ v2.10
  109.  
  110.  
  111.  
  112.           OPERATING EZ-DIZ:
  113.           -----------------
  114.           EZ-DIZ is very simple to operate. No setup or configurations
  115.           are required. It is suggested that a batch file be used to
  116.           call EZ-DIZ in order to eliminate keystrokes. Study the
  117.           enclosed examples for reference.
  118.  
  119.           EZ-DIZ should be placed in any convenient directory, and must
  120.           have available to it either directly, or in the path, of the
  121.           appropriate versions of PKUNZIP/PKUNPAK/PAK/LHA/ARJ in order to
  122.           be able to retrieve the FILE_ID.DIZ or DESC.SDI file from the
  123.           archives. EZ-DIZ must be called from the directory it (and its
  124.           keyfile, REGISTER.KEY) are in. Note that this is different from
  125.           previous versions.
  126.  
  127.           EZ-DIZ relies on two command line arguments passed to it upon
  128.           invocation. The first argument is the fully qualified path and
  129.           filename of the PCBoard directory file to be updated (Example:
  130.           C:\PCB\GEN\UPDIR). The second argument is the name of the
  131.           archived file to be processed (Example: D:\UPLOADS\EZ-DIZ.ZIP).
  132.           An example of such a command line might be:
  133.  
  134.           C:\PCB> EZ-DIZ C:\pcb\gen\updir d:\uploads\ez-diz.zip
  135.  
  136.           Use of a batch file with replaceable parameters would look
  137.           like this:
  138.  
  139.           DIZ.BAT
  140.           REM - Process one zip file
  141.           echo off
  142.           ez-diz c:\pcb\gen\updir d:\uploads\%1
  143.  
  144.           The above would be called as:
  145.  
  146.           C:\UPLOADS> DIZ ez-diz.zip
  147.  
  148.  
  149.           B-DIZ BATCH FILE:
  150.           ------------------
  151.           When calling up EZ-DIZ, you may want to automatically process
  152.           the entire directory without intervention. Consider the following
  153.           batch file example:
  154.  
  155.           B-DIZ.BAT
  156.           REM - Process all files in d:\uploads
  157.           for %%x in (d:\uploads\*.*) do ez-diz c:\pcb\gen\updir %%x
  158.  
  159.           The above command line will process every archive file in the
  160.           specified uploads directory, placing any FILE_ID.DIZ or DESC.SDI
  161.           descriptions found into the directory file UPDIR in the C:\PCB\GEN
  162.           subdirectory. This process runs very quickly. By calling one
  163.           or more batch files with different archive format specifications
  164.           (ie... d:\uploads\*.arj would process all ARJ), one can exercise
  165.           great power over which files are supported or processed.
  166.  
  167.  
  168.           OPERATIONAL NOTE:
  169.           -----------------
  170.           EZ-DIZ places a temporary placeholder in the dir file for the
  171.           zipfile's size and date. If you view the dir file with a text
  172.           editor immediately after running EZ-DIZ, you will see a 1 byte
  173.           file size and 01-01-80 for the date. Do not be alarmed...the
  174.           placeholder will be replaced with the proper information when
  175.           PCBFiler resaves the file the first time. If this poses a "real
  176.           time" problem, you may run PCBFiler with the command line switch
  177.           to update & force a save in your event right after EZ-DIZ
  178.           runs. (Future enhancements in this area are planned)
  179.  
  180.           ACKNOWLEDGEMENTS:
  181.           -----------------
  182.           PAK; NoGate Consulting
  183.           LHA; Haruyasu Yoshizaki
  184.           ARJ; Robert K. Jung
  185.           PKUNZIP, PKUNPAK; PKWare, Inc.
  186.           PCBoard, PCBDesc, PCBFiler; Clark Development Co., Inc
  187.  
  188. ------------------------------------------------------------------------------
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.